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Preface 



About this guide 

This guide describes how to configure and use the HP StorageWorks Storage System Scripting Utility 
to manage and monitor HP StorageWorks Enterprise Virtual Arrays (EVAs) in your environment. It 
provides information about: 

• Starting the utility 

• Utility commands and syntax 

Intended audience 

This guide is intended as a reference guide for HP Command View Enterprise Virtual Array (EVA) users 
and administrators. 

Prerequisites 

Prerequisites for using this product include knowledge of: 

• Storage area networks (SANs) 

• SAN fabric configurations 

• HP StorageWorks Enterprise Virtual Array (EVA) 

• Host operating systems intended for array monitoring 

This guide assumes you have installed HP Command View EVA on a supported management server. 

Related documentation 

In addition to this guide, please refer to other documents for this product: 

• HP StorageWorks Command View EVA installation guide 

• HP StorageWorks EVA software compatibility reference 

• HP StorageWorks Command View EVA online help (accessible from the HP Command View 
EVA user interface) 

• HP StorageWorks Enterprise Virtual Array user guide 

• HP StorageWorks Continuous Access EVA administrator's guide 

You can find these documents on the following HP web sites: 

http://h1 8006. www 1 .hp.com/ products/storaqe/software/cmdvieweva/index.html 
http:/ /h 1 8006. www 1 .hp.com/ products/ storage/ software/ conaccesseva/index.html 
http://h1 8006. wwwl .hp.com/storaqe/arraysystems.html 
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Document conventions and symbols 



Table 1 Document conventions 



Convention 


Element 


MGclium bluG tGxt! Figur© 1 


Cross-reference links ond e-moil oddresses 


Medium blue, underlined text (http;/ /www.hp.com) 


Web site addresses 


Bold font 


• Key names 

• Text typed into a GUI element 

• GUI elements that are clicked or selected, such as 
menu and list items, buttons, and check boxes 


Italics font 


Text emphasis 


Monospace font 
or 

CAPITAL FONT 


• File and directory names 

• System output 

• Code 

• Commands 


Monospace, italic font 


♦ Code variables 

• Command line variables 


Monospace, bold font 


Emphasis of file and directory names, system output, 
code, and commands 



A 



CAUTION: 

Indicates that failure to follow directions could result in damage to equipment or data. 



rwjo NOTE: 

Provides additional information. 



HP technical support 



Telephone numbers for v/orldv/ide technical support ore listed on the HP web site: 
http:/ / www.hp.com/ support/ . 

Collect the following information before calling: 

Technical support registration number (if applicable) 
Product serial numbers 
Product model names and numbers 
Applicable error messages 
Operating system type and revision level 
Detailed, specific questions 
For continuous quality improvement, coils may be recorded or monitored. 

HP strongly recommends that customers sign up online using the Subscriber's choice web site: 
http:/ / www.hp.com/ go/ e-updates . 
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• Subscribing to this service provides you with e-mail updates on the latest product enhancements, 
newest versions of drivers, and firmware documentation updates as well as instant access to 
numerous other product resources. 

• After signing up, you can quickly locate your products by selecting Business support and then 
Storage under Product Category. 

Service tools 

HP is constantly enhancing its service tools to keep pace with new product introductions. It is imperative 
that you check the service tools web site for the latest available downloads and install them on your 
system. This will ensure that the system tools work with your HP products effectively and efficiently. You 
can locate the services tools at the following web site: http://h1 8000. www 1 .hp.com/support/svctools/ . 

HP-authorized reseller 

For the name of your nearest HP-authorized reseller: 

• In the United States, call 1 -800-282-6672. 

• Elsewhere, visit the HP web site: http://www.hp.com . Then click Contact HP to find locations and 
telephone numbers. 

Helpful web sites 

For other product information, see the following web sites: 

• http://www.hp.com 

• http:/ / www.hp.com/ go/ storage 

• http://www.hp.com/support/ 

• http:/ / www.docs.hp.com 

Providing feedback 

To provide e-mail feedback on: 

• HP Command View EVA: CVfeedback@hp.com 

• HP Business Copy EVA: BCfeedback@hp.com 

• HP Continuous Access EVA: CAfeedback@hp.com 
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1 Getting started 



HP StorageWorks Storage System Scripting Utility (hereafter called the utility) is a command line interface 
that allows you to configure and control EVA arrays. Use the utility to script and run repetitious and 
complex configuration tasks. Use HP StorageWorks Command View EVA, the graphical user interface, 
for simple or initial configuration tasks 

This chapter includes information on how to install and use the utility. The following topics are covered: 

• Description 

• Getting Started 

• Security Considerations 

• Installing the Storage System Scripting Utility 

• Starting the Storage System Scripting Utility 

• Understanding paths and naming conventions 

• Aliases 

• Formatting and Output of Return Data 

• Replica Resync with Snapclones 

• Creating Snapclones 

• Cross Vraid 



NOTE: 

^ The CAPTURE CONFIGURATION command is the only way to capture, save, and recreate a storage 
system's configuration. After you have successfully created a storage system, use the CAPTURE 
CONFIGURATION command to create scripts that you can use to recreate a storage system in the event 
of failure or to create an exact replica. 



rmi# NOTE: 

Although this guide shows commands spanning more than one line, always enter the command on 
one line. 



NOTE: 

\^ OS_UNITJD and CONSOLEJUNJD 

This value is used for IBM AIX (set to zero), OpenVMS (required), and Tru64 UNIX (recommended). 
Other host operating systems ignore the value. 



■>3-V NOTE: 



With this release of the utility, the SHOW commands have been replaced with the LS commands. The 
SHOW commands remain available, but are deprecated. 
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r"-V NOTE: 



When a controller pair has been password-protected and the password has not been added in HP 
Command View EVA, the utility commands will display: 

Error: API unable to get the lock 



■mvfi NOTE: 

In when you are using the utility, you can not move objects between folders. 
mi4> NOTE: 

In rare instances, the utility loses communication with HP StorageWorks Command View EVA and reports 
that it is down, stopped, or restarting even though it is possible to browse to HP StorageV/orks Command 
View EVA 4.0. To fix this, restart HP StorageWorks Command View EVA. 



■2«i^ NOTE: 

On the HSV200 controllers only, the fabric port names in the output from the HP EVAPerf CLI's ps 
command are reversed. FPl should be FP2 and vice versa, for both controllers. 



rmi4> NOTE: 

You may experience a condition where the symptom is a No Object Found error or a Neither 

Success or Failure error. 

To resolve this: 



• Wait a few seconds and the problem may resolve itself 



or 



• Close all of your open browser windows, including the HP StorageWorks Command View EVA 
windows. The utility does not need to be restarted. If the problem persists after these steps, restart 
HP StorageWorks Command View EVA v4.0. 



Getting started 

To get started using the utility, follow these steps: 

1 . Select on HP Command View EVA instance (or server) using the select manager command. 
Use the select manager command to direct the command prompt to a specified server. All 
configuration commands run on the selected array and affect the array's configuration. The 
<manager_name> can be a server or an IP address. You can also use localhost if you are 
logged directly on the management server. Unless the storage administrator has changed the 
password, the default password is "administrator" and the default user is "administrator". 
Syntax (to select the HP Command View EVA instance — or server): 

SELECT MANAGER <manager_name> USERNAME=<username> PASSWORD=<pass- 
word> 

2. View available arrays using the LS SYSTEM command Syntax: LS system 

3. Select an array to manage using the SELECT SYSTEM command Syntax: select system 
<system_name> 
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Security considerations 

ProLiant servers and Smartstart 7.2 

If you will be running the utility on a ProLiant server, please read "Password security incompatibility" in 
the HP StorageWorks Command View EVA installation guide 

For the latest versions of storage documentation, access the HP storage web site at 
http://www.hp.com/country/ us/enq/ prodserv/storaqe.html . 

Installing the utility 

This section covers installing the utility. 

Installation 

1 . For Windows, the utility is installed when you install HP Command View EVA in: 

C:\Program Files\Hewlett-Packard\SANworks\Element Manager for 
StorageWorks HSV\Bridge 

If you are using other operating systems, you need to download the software at the following uri: 
http://h1 8006. wwwl .hp.com/ products/storaqe/software/cmdvieweva/index.html 

2. Unzip the file and copy the binary to the location of your choice. 

Once installed, the utility runs as a simple executable. For convenience, you can add the directory 
containing the utility executable to your path or copy the executable to a directory already in your 
path. Ensure that the utility executable's attributes are set with the correct security and execution flags 
appropriate for your environment. 



Starting the utility 



The utility starts as a command prompt window, shell, or equivalent. To start utility, enter the following 
command prompt: 



sssu.exe 



■5-Mio NOTE: 



The SET OPTIONS command (see SET OPTIONS) controls how utility behaves. The options you set 
with the SET OPTIONS command are in effect for the current session only. Each time you start the 
utility, the default options are reinstated. 



Syntax 

SSSU <additional arguments> 

If the utility is started without arguments, a generic application <NoSystemSelected> prompt is 
displayed on the terminal and input can be accepted. 

If the utility is started with arguments, those commands are echoed to the input terminal and executed, 
and then the utility exits. 
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NOTE: 

t— I You must enclose in double quotes any commands or object names that have embedded blanks (spaces). 
Examples 

sssu 

This example starts the utility without additional arguments and prompts you for commands. 

SSSU "FILE snapDl.txt" 
This example starts the utility and then executes the file snapDl .txt from the current directory. 

SSSU "cmdl" "cmd2" "cmd3" 
This example starts the utility and executes multiple commands. 

Shortcut commands 

The utility commands and switches can be shortened to the length that makes them unique. For example, 
a shortcut for EMVERSION could be EM (note that using just the letter E would not make the command 
unique since EXERCISE_DISK also starts with the letter E). 

Understanding paths and naming conventions 

This section describes important information about paths and naming conventions in the utility, 
rwjo NOTE: 

For detailed descriptions of the following commands, refer to Chapter 2. 
The following important root folders let you organize your array: 

You cannot create root-level folders. You can, however, create additional folders within the \Hosts\ and 
Wirtual Disks\ folders to organize your array (see ADD FOLDER) 

"\Hosts\" 
"\Disk GroupsX" 
"\Data ReplicationV" 
"\Hardware\" 
"Wirtual DisksX" 



Virtual disk example 



Due to the space in the root name for the Virtual Disks folder, you must always enclose strings that include 
the name of this folder within double quotes (""). 

ADD VDISK "Wirtual Disks\new_code" SIZE=10 

This example creates a virtual disk family named new_code in the default disk group. 

This is a virtual disk family. The actual virtual disk name (the active virtual disk) is Wirtual 
Disks\new_code\ ACTIVE. 
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NOTE: 

If you create a virtual disk (using ADD VDISK) within a deeper folder structure, you need to include the 
full path within double quotes. 

ADD VDISK "Wirtual Disks \engineering\gene_research" SIZE=2 

Disk groups example 

This example uses an alias to identify a disk group. 

LS disk;_group admin 

Aliases 

The utility commands recognize an alias, so you do not need to use full names except for LUN names. 

Virtual disk example 

If you have \virtural_disks\my_virdisk\Active, you can enter my_virdisk for the object. If 
your object name contains spaces, the double quotes are mandatory. 

Disk group example 

If you have \Disk Groups\Def ault Disk Group, you can enter Default Disk Group for the object. 
NOTE: 

If you do not specify a full name, the utility checks to see if you are using an alias. However, LUNs need 
to be specified with a full name. This is because LUNs are not uniquely identified by numbers and several 
different virtual disks can have a LUN 1 presentation. In this instance, the full path name is required. 

For example, if you are specifying a LUN, you need to specify the full LUN name: 

LS lun \Hosts\MainServer\3 

SET example 

To specify a host without aliases: 

SET host \Hosts\hl name=h2 
To specify a host with aliases: 

set host hi name=h2 

Add snapshot example 

To add a snapshot without aliases: 

add snapshot mysnap vdisk=" \Virtual Disks\mydisk\ACTIVE" 
To add a snapshot with aliases: 

add snapshot mysnap2 vdisk=mydisk 
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Delete virtual disk example 

To delete a virtual disk without aliases: 

delete vdisk "Wirtual Disks\mydisk\ACTIVE" 
To delete a virtual disk with aliases: 

delete vdisk mydisk 

Formatting and output of returned data 

Most return LS command data can be formatted in the optional XML format. 

The regular output of the LS command is in the format: 

XML element : value 



To specify XML output, add the XML switch. For example, the following command: 

LS vdisk vdOl XML 
provides the following XML output: 

<objectname> Wirtual Disks\vd01\ACTIVE</ob jectname> 



NOTE: 

t— I The LS commands provide a flexible format to display system data. The SHOW commands are still 
available for script compatibility, but they are deprecated (available, but not supported). 



Replica resync with snapclones 

Replica resync allows you to revert back to a previous point-in-time (snapclone) if a virtual disk becomes 
corrupted. The process involves changing the corrupted virtual disk into a container (using the SET VDISK 
CHANGE_INTO_CONTAINER command). This will create an empty container with the same settings 
as the original virtual disk. You can then restore the virtual disk data by creating a snapclone of the 
previously taken backup snapclone. When the new snapclone completes, it will become an independent 
virtual disk with the same settings as the previously corrupted virtual disk. Your data will be as current as 
your most recent backup snapclone. 



Creating snapclones 

With this release of the utility, a snapclone of a virtual disks can be preallocated using containers. 
Containers provide a more efficient way to create snapclones because they can be created before they 
are needed for a snapclone. Additionally, reserving the disk space ensures the amount of space needed 
for the snapclone will be immediately available when it is needed. Containers are created using the 
ADD CONTAINER command. 



Cross Vraid 

Cross Vraid for snapshot and snapclone allow customers to change the Vraid type when creating 
snapshots or snapclones for better disk utilization. Cross Vraid is supported in the following manner: 



1 8 Getting started 



• Cross Vraid Snapshot (ADD SNAPSHOT) and Snapclones (ADD COPY) within the same disk 
group. 

• Cross Vraid Snapclones (ADD COPY) across disk groups (including standard and FATA disk 
groups) 

Refer to ADD COPY and ADD SNAPSHOT for more information. 



NOTE: 

You cannot create a snapshot of a RAID level that is more available than the parent Vdisk. For example, 
you cannot create a snapshot of Vraid 1 if the parent Vdisk is VraidO. The reason is that if the parent 
Vdisk is lost, the snapshot will not be more available than the parent Vdisk. 

Subsequent snapshots of a virtual disk must be of the same redundancy level. For example, if you create 
a VraidS snapshot of a Vraid 1 virtual disk, then all other snapshots of the original virtual disk must also 
be VraidS. As an example, you could have seven VraidS snapshots of the original Vraid 1 virtual disk. 

Vraid availability in order, from highest to lowest is: Vraidl, VraidS, and VraidO. 

The maximum number of snapshots you can create for a single virtual disk is 7. 



HP StorageWorks Storage System Scripting Utility reference 



19 



Getting started 



2 Utility command reference 



This chapter defines all the commands and switches available in the utility, including: 

• ADD 

• CAPTURE 

• DELETE 

• EMVERSION 

• EXERCISE DISK 

• EXIT 

• FILE 

• HELP 

• LS 

• REDISCOVER 

• RESTART 

• SELECT 

• SET 

• SHUTDOWN 

In addition, this chapter includes syntax and examples. The commands are presented in alphabetical 
order. 



mf NOTE: 

^ When running an SSSU script from a file, the entire file argument must be contained in double quotes. 
For example 

Sssu "file myscript.txt" 

In addition, if the file path name contains spaces, then it too must be in double quotes and be designated 
with the ASCII escape character "\". For example: 

Sssu "file \ "c : \program files\myotherscript.txt"" 



r»h^ NOTE: 



The LS commands should be used in place of the SHOW commands. This version of the utility no 
longer supports the SHOW commands (they are deprecated). However, previous scripts using the 
SHOW commands will still work. 



Command introduction 

You can display a list of switches for each command directly within the interface by entering a ? after 
the command or option name. For example, ADD ? displays all of the switches available with the ADD 
command, and ADD SYSTEM ? displays the switches available for the ADD SYSTEM command (see HELP). 

Remember when you issue commands: 
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• You can use the alias to specify names. 

• If a patfi name contains a space, enclose the entire name in double quotes (""). 

Chapter 3 — Configuration Example, provides a simple configuration example for using these commands 
to create and present a single LUN to a host. It also includes sample output from LS commands. 



rio^ NOTE: 

t— I Command keywords are not case sensitive, and it is often not necessary to type complete command 
names. For example, you can type em for EMVERSION or shu for SHUTDOWN. However, user created 
object names may be case sensitive if they are intentionally created with uppercase and lowercase 
characters. 



Menu map 

A menu map is shown on the next few pages. You can use this as a graphical reference for the utility 
commands. 
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Command 



Option 



CONTAIH 



- PlSK_GROUl 



DR GROUP 



- FOLDBH 

L 

- IhOST ~ 



SHflPS HQT- 




CONFIGURATION 
VALIDATE 

DISK_GROUP 
DR GROUP 
FOLDER 
HOST 
LUN 

SYSTEM 
VCHSK 



■ DISK_GROUP 

■ REDUNDANCY 
SIZE 



- CONTAINER 

- DISK_QROUP 

-NOWAIT FOR COMPLETION 
-OS UNIT ID 

- REDUNDANCY 

- VDISK 

- WAIT_FOR_COMPLETION 

- WORLD WIDE LUN NAME 

COMMENT 
DEVICE COUNT 

- DiSKGROUP_DiSKTYPE 

- OCCUPANCY ALARM 
SPARE POUCY 




AC CESS MODE 
- COMMENT 

- DESTINAT10N_DISK_GR0UP 
-DESTINATION SYSTEM 

- DESTINAT10N_U DISK_NAIUIE 

- UNK_DOWN_AUTOSUSPEND 
-LOG_DESTINATION_DISK_GROUP 

LOG_SOURCE_DISK_GROUP 
MAX LOG SIZE 
TARGETREDUNDANCY 

- VDISK 
WRITEMODE 




COMMENT 



- COMMENT 



- OPERATING_SYSTEM 

- WORLD VWIDE NAME 



- HOST 

- VDISK 




ALL0CAT10N_P0LICY 
OS UNIT ID 

- REDUNDANCY 
VDISK 

; WORLD WIDE NAME 

-COMMENT 
-CONSOLE LUN ID 
-DEVICE_COUNT 

- DiSKGROUP DiSKTYPE 
■ SPARE_POUCY 



- COMMENT 

- DiSK_eROUP 
MIRRORCACHE 
NOPERFERED_PATH 

- NOREAD CACHE 

- NOWAIT FOR COMPLETION 
NOWRITE PROTECT 

- OS_UNIT_ID 
■ PREFERRED PATH 

REDUNDANCY 
READ_C AC HE 

- SIZE 

- WAIT_FOR_COMPLETION 
-WORLD WIDE LUN NAME 

WRITEC AC HE 

- WRITE PROTECT 





WAIT FOR COMPLETION 
N0WAiT_F0R_C0MPLET10N 



Figure 1 Menu map (part A) 
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STOP 
SUMMARY 



COMT/MNE 



DISK_GRC 



OlSKSHEL 



OPTIONS 
SNAPSHOT 



- ALL ■ 

. tfst of ttjJJy quaJifjed disk names {comma separatee!} 



- FULL 

- NO FULL 



■ name of oi>ject to stiow 

■ FULL ^^^^^^H 

■ MO FULL ^^^^^^H 



■ name of ottject to sfiow 

- FULL ^ 

- NO FULL ^^^^^^H 



■ name of object to show 
- FULL 

NO FULL 

■ name of object to show 

. FIJI I I 



NO FULL 



' name of object to show 



N( >l III I 



■ name of object to show 

- FULL ^^^^^^^ 

- NO FULL ^^^^^^^M 



■ name of object to show 

■ FULL '^^^^^^H 
NOFULL ^IH^^^H 



' name of object to shoiv 

- FULL 

- NOFULL 

i 



name of object to s/iouv 

FULL 
■ NOFULL 

name of object to shonv 



-FULL 

- NOFULL 



i_ 



' name of object to show 
- FULL ^^^gg^^^ 
' NOFULL ■^■■■■H 



name of object to show 



- FULL 
NOFULL 



3RLD WIDE 



name of object to show 



XML 
XML 



XML 
■ XML 



- XML 



XML 
- XML 



XML 
XML 



XML 
XML 



XML 
XML 



XML 
- XML 



■ XML 
XML 



■ XML 
XML 



Figure 2 Menu map (part B) 
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nsm e of power object 



MANAGER 



. CONTROLLER 



- DISK_GROUF 



DISK_SHELF_J 



DR_GROUP 



..OPTIofl 



ALL PEERS 
NOALL_PEERS 



- tP acfdrsss of ma/yagirtg appiiance 



-PASSWORD 
-USERHAME 



- narrts of storags system 



- COIUIMENT 

- NAME 



- COMMENT 

- NAME 



- ADD 

- COMMENT 

- DELETE 

■ OCCUPANCY_ALARM 
SPARE_POLICY' 

- NAME 




- NAME 

-ACCE SSMODE 

- ADD_VDI SK 
"COMMENT 

- DE LE TE_VDI SK 

- DETA CH_VDI SK 

- FAILOVER_RESUME 
-FA I LOVER_ SUSPEND 
—FAILSAFE 
-FORCEFULLCOPY 
-LINK_DOVVN_AUTO SUSPEND 
-MAX_LO G_SIZE 
-NOFAILSAFE 

- NO SUSPEND 
- SU SPEND 

- WRITEM ODE 
-NAME 

- COMMENT 
_ NAME 



ADD_VVORLD_WlDE_NAME 
- COMMENT 

■ DELETE_WORLD_WlDE_NAME 



-OP ERA TIM G_SV STEM 
. NAME 



-COMMENT 
- NAME 



COMMAND_DELAY 

DISPLAY_V\/IDTH 

NOCOMMAND DELAY 
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Figure 3 Menu map (part C) 



ADD 



Use the ADD commands to create new arrays, folders, disk groups, DR Groups, virtual disks, snapshots, 
snapclones, as well as to add LUNs and hosts within the EVA. 
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r»hA> NOTE: 



Creating DR groups and snapshots of virtual disks is dependent on your licensing. See the documentation 
that came with your hardware for more information. 



ADD CONTAINER 

Use the ADD CONTAINER command to reserve disk space to create copies of virtual disks (snapclones). 
You can create containers and reserve the space before they are needed for a snapclone. Reserving 
space allows you to quickly and safely create a copy because the space for the copy is already reserved 
and available. You must specify the size of the container when you create it (there is no default). 

After the copy is created, it becomes another virtual disk. You can reverse the process and turn a virtual 
disk back into a container using the SET VDISK CHANGEJNTO_CONTAINER command. 

If the disk group is not specified, it is created in the default disk group. If the default disk group does 
not exist, an error message will be generated. 



r"-V NOTE: 



When you delete a container, the option WAIT_FOR_COMPLETION is ignored. After deletion, the 
container may still appear during an LS command. This is because the container is deleted in the 
background and will continue to appear until it is fully deleted (this is an asynchronous only operation). 



Syntax 

ADD CONTAINER <container_name> SIZE=<n> 



Switches 

The following switches are available with the ADD CONTAINER command. 
DISK_GROUP= 

This is the name of the disk group where you want to create the container. 
REDUNDANCY= 

The amount of data protection set when creating the virtual disk. If not specified, the default is Vraidl . 

• VraidO— Provides no data protection. It distributes data among its member disks into stripes 
and uses all members to process I/O requests. This method has no overhead associated with 
duplication of information and provides the highest performance. 

• Vraidl —Provides the highest level of data protection but uses the most space. It duplicates data 
written to one disk onto a backup disk. In a multidisk configuration, Vraidl mirrors each pair of 
disks to each other. These disk pairs can then be striped to create a virtual disk. 

• VraidS— Provides a moderate level of data protection. This method distributes the parity 
information among all disk members. If one drive fails, the failed disk can be recreated after it is 
replaced. 

SIZE= 

This is size of the container. Enter decimal value in GB. 
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ADD COPY 



Use the ADD COPY command to create a copy of the specified virtual disk. A copy is a new virtual disk 
family. The ADD COPY command is equivalent to creating a snapclone within HP Command View EVA. 



r>Mio NOTE: 



Creating copies of virtual disks depends on your licensing. Attempting to add a copy without the license 
returns an error message that indicates that you need to enter your licensing information in the HP 
Command View EVA. You must have a registered license. 



Syntax 

ADD COPY <copy_name> VDISK= Octive member of a vdisk family> 



Switches 

The following switches are available with the ADD COPY command. 



CONTAINER= 

This is the name of the container you would like to use for the virtual disk copy. The container must 
already exist to use this switch. The container option is optional. If not specified, the add copy command 
will still function by dynamically allocating the storage before starting the copying process. 

DISK_GROUP= 

This is the name of the disk group where you wont to create the virtual disk copy. The disk group must 
already exist to use this switch. If not specified, the utility uses the same group as the source virtual disk. 



r>Mio NOTE: 



The source virtual disk must be set to writecache=writethrough before a preallocated snapclone 
(using a container) can be created. See SET VDISK section for more information. 



OS_UNITJD= 

The ID that is presented to the host operating system. If set to zero, no ID is presented to the host. 
REDUNDANCY= 

The amount of data protection set when creating the virtual disk. The default is the some as the source 
virtual disk. 

• VraidO— Provides no data protection. It distributes data among its member disks into stripes 
and uses all members to process I/O requests. This method has no overhead associated with 
duplication of information and provides the highest performance. 

• Vraidl —Provides the highest level of data protection but uses the most space. It duplicates data 
written to one disk onto a backup disk. In a multidisk configuration, Vraidl mirrors each pair of 
disks to each other. These disk pairs can then be striped to create a virtual disk. 

• VraidS— Provides a moderate level of data protection. This method distributes the parity 
information among all disk members. If one drive fails, the failed disk con be recreated after it is 
replaced. 
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VDISK= 

This is the virtual disk name to be copied (active member of a virtual disk family). 

WORLD_WIDE_LUN_NAME= 
Sets the World Wide LUN Name. 

WAIT_FOR_COMPLETION 

Waits until the command's operation finishes before displaying the next utility prompt (and returning 
control) or before running another script line. For large (greater than 1 TB) virtual disks, using this option 
can result in a long period before the prompt appears. 

NOWAIT_FOR_COMPLETION 

Returns control as soon as possible. Some operations are invalid until the initial operation finishes in 
the background. 

Required Switch 

The follov/ing switch is required with the ADD COPY command: 
VDISK= 

Examples 

ADD COPY wednesday_nite VDISK="\Virtual Disks\payroll\ACTIVE" 
This example copies the virtual disk payroll to a copy named wednesday_nite. 

ADD COPY save_reports VDISK="\Virtual Disks \daily_biz \ACTIVE" 
DISK_GROUP="\Disk Groups \ small_disks " 
This example creates a copy of daily_biz named save_reports within the specified disk group. 

1-2^ NOTE: 

LI When you use the ADD COPY command, you are actually creating a virtual disk. If you want to delete 
the virtual disk, you must use the DELETE VDISK command. 

ADD DR_GROUP 

Use the ADD DR GROUP command to create a data replication group containing the specified source 
virtual disk. This source virtual disk is replicated on the specified destination array. 

Syntax 

ADD DR_GROUP <dr_group_name> VDISK=<vdisk> DESTINATION_SYSTEM=<system> 

Switches 

The following switches are available with the ADD DR_GROUP. 
ACCESSMODE= 

The access rights for a connected host. Possible values are: presentonly, readonly, and disable. 
The default is disable, and this is the safest setting. 
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rm-i4> NOTE: 

Setting ACCCESSMODE to readonly or presentonly could seriously impede host OS operation. 
r2«j<> NOTE: 

The default disable is displayed in the GUI as none. 
COMMENT= 

Used to attach comments to the DR Group being created. The comment string must be enclosed in quotes. 
The maximum number of characters for this optional switch is 64. 

DESTINATION_SYSTEM= 

The system on which the destination virtual disks are created. 
DESTINATION_DISK_GROUP= 

The disk group name in which the virtual disk on the destination array is created. 
DESTINATION_VDISK_NAME= 

The name of the virtual disk that is created on the destination array. The default name is the same 
as that of the source. 

LINK_DOWN_AUTOSUSPEND= 

When enabled, the DR replication will be automatically suspended if the link between the arrays goes 
down. It will stay suspended even if the link returns. The available values are: Enable and Disable. 

LOG_DESTINATION_DISK_GROUP= 

This is the disk group for the DR log disk on the destination array. 
LOG_SOURCE_DISK_GROUP= 

This is the disk group for the DR log disk on the source. 
MAX_LOG_SIZE= 

This is the maximum size for the DR log disk. The value is the number of blocks in 51 2 bytes. If left 
blank or set to 0 (zero), the controller firmware will calculate the best log size for the space available. 
Otherwise, you con specify a size, which must be between 1 36MB and 2TB entered in blocks: 278528 
through 4294967296. 

■mi4> NOTE: 

If you specify a size that is larger the available disk space, the command will complete successfully, and 
the DR group will be created (even though the space is not available). If additional disks are added to 
the configuration, the controller will allocate more data for the DR log. 

TARGETREDUNDANCY= 

This is the redundancy of the remote virtual disk that will be created on the destination array. 
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VDISK= 

The name of a source system virtual disk to be placed within the DR Group. A destination virtual disk is 
automatically created on the destination array. 

WRITEMODE= 

Defines the I/O interaction between the destination and source. Possible values are synchronous and 
asynchronous. The default is synchronous. 

Example 

ADD DR_GROUP Transactions DESTINATION_SYSTEM=remote_scell 

VD I SK=" /Virtual Di sks /Hawai i /ACTIVE" 

This example creates a DR Group named Transactions that contains the source virtual disk 
Wirtual Disks\Hawaii\ACTlVE. This DR Group will be connected to the destination array 
remote_scell, on which the destination virtual disk Wirtual Disks\Hawaii\ACTlVE (same as 
the source by default) will be created and added to the destination DR Group. 

Required Switches 

The following switches are required for the ADD DR GROUP command. 

• DESTINATION_SYSTEM = 

• VDISK = 

ADD DISK_GROUP 

Use the ADD DISK_GROUP command to add disk groups to the array. 

Syntax 

ADD DISK_GROUP <group_name> DEVICE COUNT= <a number> 

Switches 

The following switches are available with the ADD DISK_GROUP command. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new system. A maximum of 
1 28 characters is allowed, and the string must be enclosed in double quotes. 

DEVICE_COUNT= 

The number of physical disks to use for this group. The limit is the number of available disks in the array. 
The default and minimum value is 8. 

DISKGROUP_DISKTYPE= 

This parameter determines the types of disks to be considered for creating the disk group. The default 
value is ONLINE. 

• ONLINE: Only online fibre channel disks are considered for creating the default disk group. 

• NEAR-ONLINE: Only near-online fibre channel disks are considered for creating the default 
disk group. 
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OCCUPANCY_ALARM= 

The point when a defined percentage of space is used. When this point is reached, an event log is 
generated and sent to the management server (optionally the host system) informing the administrator that 
the group is becoming full. Do not use the percentage sign (%) after the number. The default is 95%. 

SPARE_POLICY= 

This parameter determines the amount, if any, of storage space set aside for use in the event that disks 
fail. The default is single. 

• NONE— Reserves no space v/ithin a disk group to allov/ for data reconstruction in case of 
failure of disk drives 

NOTE: 

^ Using a spare policy of NONE can cause data loss and is not recommended. 

• SINGLE— Reserves space within a disk group to allow for data reconstruction for failure of a 
single disk drive 

• DOUBLE— Reserves space within a disk group to allow for data reconstruction for failure of 
two disk drives 

■mi4> NOTE: 

The space set aside is not in numbers of physical disks. It is the equivalent amount of storage space 
spread across all disks. 

Example 

ADD DISK_GROUP "\Disk Groups \human_resources " DEVICE_C0UNT=12 

SPARE_POLICY=SINGLE 0CCUPANCY_ALARM=7 5 

This example creates a new disk group, human_resources. It has 1 2 physical disks with the equivalent 
of one disk set aside as a spare and sends an event log to the array when 75% of capacity is reached. 



ADD FOLDER 

Use the ADD FOLDER command to create a new folder within the specified folder to aid in organizing 
your array. You can create folders only under the virtual Disks and Hosts root folders. You 
cannot create root folders. 

For example, if you have a controller that is serving Human Resources (HR) and Engineering, you could 
create four folders— two to separate the virtual disks and two to separate the hosts: 

• \Virtual Disks\Engineering and \Virtual Disks\HR 

• \Hosts\Engineering and \Hosts\HR 

Creating these folders allows you to put engineering virtual disks and hosts in the Engineering folders 
and Human Resources storageXhosts in the HR folders. This makes it easier to keep track of the 
components within your array. If you want to nest folders inside folders, you must add one folder at a time. 



Syntax 

ADD FOLDER <f older_name> 
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Switch 



Only the COMMENT switch is available with the ADD FOLDER command. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new array. A maximum of 128 
characters is allowed, and the string must be enclosed in double quotes. 

Examples 

ADD FOLDER \Hosts\human_resources 

This example creates a new folder human_resources within the root folder Hosts. 
ADD FOLDER "\Virtual Disks\colorado\colorado springsXengineering" 

In this example, the folder structure must already have been in place before creating the new folder 

engineering. 

ADD HOST 

Use the ADD HOST command to add a host and its World Wide Name (WWN) to the list of hosts that 
can connect to virtual disks within the current array. 

The ADD HOST command adds one Fibre Channel Adapter (FCA) only. The SET HOST command 
adds each subsequent FCA. 

Syntax 

ADD HOST <host_name> WORLD_WIDE_NAME= <wor ld_wide_name> 

Switches 

The following switches are available with the ADD HOST command. 
IP= 

This is the network IP address. If the IP address is not specified, the name of the host will be used 
as a DNS name. 

COMMENT= 

This is an optional switch that associates a user-defined comment with the new system. A maximum of 
1 28 characters is allowed, and the string must be enclosed in double quotes. 

OPERATING_SYSTEM= 

The type of operating system for the specified host. For the default operating system, refer to Agent 
Options - User Interface Options in the user interface. Choose one of the following operating systems 
(they are spelled here as the utility expects): 
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• CUSTOM 

The correct syntax is 

0PERATING_SYSTEM=CUST0M=<16 hex characters> 

• HPUX 

• IBMAIX 

• OPEN_VMS 

• SOLARIS 

• TRU64 

• LINUX 

• UNKNOWN 

• WINDOWS 

WORLD_WIDE_NAME= 

The World Wide Name of the Fibre Channel adapter. 
Required switch 

The WORLD_WIDE_NAME switch must be set to ensure that HP Command View EVA recognizes the host 
added with the ADD HOST command. 

Example 

ADD HOST \Hosts\development WORLD_WIDE_NAME=5000-lfel-ff 00-0000 
This example adds a host development with an adapter at a WWN of 5000-1 fel-ffOO-0000. 

ADD LUN 

The ADD LUN command makes previously created virtual disks available to a host. 

Syntax 

ADD LUN <LUN_number> VDISK=<storage_name> HOST=<host_name> 

Switches 

The following switches are available with the ADD LUN command. 
HOST= 

The name of the host to which the LUN is presented. 
VDISK= 

The name of the virtual disk that is presented to the host. 
Required switches 

Set the following switches so that HP Command View EVA recognizes the LUN you add with the ADD 
LUN command. 

• HOST 

• VDISK 
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Examples 

ADD LUN 12 VDISK="\Virtual Disks\act\payroll\ACTIVE" HOST=\Hosts\sanf ran 

This example adds LUN 1 2, which presents the ACTIVE virtual disk for the family payroll to the host 
called sanfran. 

ADD LUN 175 VDISK=USER_DISK HOST= corporate 

This example uses aliases ad adds LUN 1 75, which presents the ACTIVE virtual disk for the family 

user_disk: to the host called corporate. 

ADD SNAPSHOT 

The ADD SNAPSHOT command creates a picture (not a full copy) of a virtual disk family's active 
virtual disk. 

M-V NOTE: 



Creating snapshots of virtual disks depends on your licensing. Attempting to add a snapshot without 
the license returns an error message. This message indicates that you need to enter your licensing 
information in the HP Command View EVA. You must have a registered license. 

Syntax 

ADD SNAPSHOT <snapshot_name> VDISK=<vdisk_to_snapshot> 

Required switch 

The following switch is required with the ADD SNAPSHOT command: 

VDISK= 

Examples 

ADD SNAPSHOT payroll_backup VDISK=" Wirtual Disks\payroll\ACTIVE" 

ALLOCATION_POLICY=DEMAND 

This example creates a snapshot payroll_backup from the ACTIVE member of virtual disk family 
payroll that uses capacity only as needed. 

ADD SNAPSHOT wed_nite_biz VDISK=daily_biz ALLOCATION_POLICY=FULLY 

This example creates a snapshot wed_night_biz from the ACTIVE member of the family daily_biz 
while reserving all capacity necessary to create the snapshot. 

NOTE: 

To delete snapshots created by ADD SNAPSHOT, use the DELETE VDISK command. 

Switches 

The following switches are available with the ADD SNAPSHOT command. 
ALLOCATION_POLICY= 

Indicates how the space for the snapshot is allocated. 
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• DEMAND— Storage is allocated for the snapshot only when required. As the snapshot and the 
original storage's information diverges, the space allocated for the snapshot increases. 

• FULLY— All storage required to fully contain a snapshot is allocated when the snapshot is created. 
This is the conservative method to create a snapshot, because adequate space is guaranteed for 
a full snapshot. This is the default. 

OS_UNIT_ID= 

The ID that is presented to the host operating system. If set to zero, no ID is presented to the host. 
REDUNDANCY= 

The amount of data protection set when creating the virtual disk. If not specified, the default is the 
setting of the source virtual disk. 

• VraidO— Provides no data protection. It distributes data among its member disks into stripes 
and uses all members to process I/O requests. This method has no overhead associated with 
duplication of information and provides the highest performance. 

• Vraidl —Provides the highest level of data protection but uses the most space. It duplicates data 
written to one disk onto a backup disk. In a multidisk configuration, Vraidl mirrors each pair of 
disks to each other. These disk pairs can then be striped to create a virtual disk. 

• VraidS— Provides a moderate level of data protection. This method distributes the parity 
information among all disk members. If one drive fails, the failed disk can be recreated after it is 
replaced. 

VDISK= 

The source virtual disk for this snapshot. 

WORLD_WIDE_LUN_NAME= 
Sets the World Wide LUN Name. 



ADD SYSTEM 

Use the ADD SYSTEM command to initialize an uninitialized array and to create a default disk group. 
You must select an uninitialized array before issuing the ADD SYSTEM command. If the system is already 
initialized, the command is rejected. 

Using the LS SYSTEM command (see LS SYSTEM) to display the names of the available uninitialized 
arrays, the uninitialized array displays as Uninitialized Storage System [WWN of the 
storage cell] . 

After initialization is complete, the utility changes its default prompt back to NoSystemSelected. 

Because the array's name changed from the uninitialized string to the name given with the ADD SYSTEM 
command, you must reselect the array. Issue the SELECT SYSTEM command using the new name of 
the array. 



pw;!^ NOTE: 
Appenc 

initialize an uninitialized array. 



Appendix A includes a configuration example that explains the sequence of commands you can use to 



Syntax 

ADD SYSTEM <system_name> DEVICE_COUNT= 
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Switches 

The following switches are available with the ADD SYSTEM command. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new array. A maximum of 1 28 
characters is allowed, and the string must be enclosed in double quotes. 

CONSOLE_LUN_ID= 

The LUN used for console communication after array creation. If set to zero, no console LUN is presented 
to the host. 

DEVICE_COUNT= 

The number of physical disks to use for the default disk group of this array. The limit is the number of 
available disks in the array. The default and minimum value is 8. 

DISKGROUP_DISKTYPE= 

This parameter determines the types of disks to be considered for creating the disk group. The default 
value is ONLINE. 

• ONLINE: Only online fibre channel disks are considered for creating the default disk group. 

• NEARONLINE: Only near-online Fibre channel disks are considered for creating the default 
disk group. 

SPARE_POLICY= 

This parameter determines the amount, if any, of storage space set aside for safety in the event that 
disks fail. 

The default is SINGLE. 

• NONE— Reserves no space within a disk group to allow for data reconstruction for failure of 
disk drives. 

• SINGLE— Reserves space within a disk group to allow for data reconstruction for failure of 
a single disk drive. 

• DOUBLE— Reserves space within a disk group to allow for data reconstruction for failure of 
two disk drives. 



r2«w> NOTE: 

The space set aside with spare policy is not in numbers of physical disks. It is the equivalent amount of 



storage space spread across all disks. 



Example 

ADD SYSTEM payroll DEVICE_C0UNT=12 SPARE_POLICY=SINGLE 

This example creates an initialized array payroll with 1 2 physical disks and a spare policy of SINGLE. 

ADD VDISK 

Use the ADD VDISK command to create a virtual disk with a specified name and parameters. 
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■>Mio NOTE: 



Syntax 



This command actually creates a virtual disk family and the ACTIVE member. After you create the 
family, an initial virtual disk, "ACTIVE," is placed as the only virtual disk in the family. This is referred 
to as the active virtual disk. 



ADD VDISK <storage_name> SIZE=<n> 
The fi is the virtual disk size in whole GBs. 



Switches 

The following switches are available with the ADD VDISK command. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new virtual disk. A maximum 
of 1 28 characters is allowed and the string must be enclosed in double quotes. 

DISK_GROUP= 

The disk group name for where you want to create the virtual disk. The disk group must already exist 
to use this switch. If not specified, the default disk group is used. 

NO_WAIT_FOR_COMPLETION 

This option returns control of the array while the virtual disk is being created and before it is complete. 
OS_UNIT_ID= 

The ID that is presented to the host operating system. If set to zero, no ID is presented to the host. 
PREFERRED_PATH= 

The preferred controller path that is specified to handle all I/O for the virtual disks. If a controller fails, 
the path always reverts to the working controller. 

• PATH_A_BOTH— Controller path A fails over to controller B. When controller A restarts, the virtual 
disks fail back to controller A. This is failover/failback mode. 

• PATH_A_FAILOVER— Controller path A fails over to controller B. When controller A restarts, the 
virtual disks do not fail back to controller A. This is failover-only mode. 

• PATH_B_BOTH— Controller path B fails over to controller A. When controller B restarts, the virtual 
disks fail back to controller B. This is failover/failback mode. 

• PATH_B_FAILOVER— Controller path B fails over to controller A. When controller B restarts, the 
virtual disks do not fail back over to controller B. This is failover-only mode. 

NOPREFERRED_PATH 

Allows the I/O to be handled by either controller. 
READ_CACHE 

Reads are satisfied from the controller's cache. 
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NOREAD_CACHE 

Reads are always satisfied from the physical disks, not the controller's cache. 
REDUNDANCY= 

The amount of data protection set when creating the virtual disk. If not specified, the default is changed 
to Vraidl . 

• VraidO— Provides no data protection. It distributes data among its member disks into stripes 
and uses all members to process I/O requests. This method has no overhead associated with 
duplication of information and provides the highest performance. 

• Vraidl —Provides the highest level of data protection but uses the most space. It duplicates data 
written to one disk onto a backup disk. In a multidisk configuration, Vraidl mirrors each pair of 
disks to each other. These disk pairs can then be striped to create a virtual disk. 

• VraidS— Provides a moderate level of data protection. This method distributes the parity 
information among all disk members. If one drive fails, the failed disk can be recreated after it is 
replaced. 

WORLD_WIDE_LUN_NAME= 
Sets the World Wide LUN Name. 



NOTE: 

This switch is commonly used to allow a host to point to a new version of the virtual disk by giving the 
new virtual disk the same WWN as the old virtual disk. 



WRITE_PROTECT 

Does not allow writing to the virtual disk for all presented LUNs/host. 
NOWRITE_PROTECT 

Turns off write protection and allows writing to the virtual disk for all presented LUNs/host. 
WAIT_FOR_COMPLETION 

Default. Waits until the command's operation completes before displaying the next utility prompt (and 
returning control) or before running another script line. For large (greater than 1 TB) virtual disks, using 
this option can result in a long period before the prompt displays. 

WRITECACHE= 

This is the cache parameter for the write operation. There are two values: WRITETHROUGH and 
WRITEBACK. With WRITETHROUGH the operation completes when the write to disk completes. With 
WRITEBACK, the operation completes when the data is written to cache. 



NOTE: 

If you are creating a preallocated snapclone (using a container), you need to change the Write Cache 
Policies from WRITEBACK to WRITETHROUGH for the source virtual disk. The reason the cache policy 
has to be changed to WRITETHROUGH is to flush any cache memory to the virtual disk before it is 
cloned. The policy of the source virtual disk will revert back to the original setting when you complete 
the creation of the snapclone. 
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MIRRORCACHE= 

This sets the controller's mirror cache. The values are MIRRORED (cache is mirrored between both 
controllers) and NOTMIRRORED (cache is not mirrored). 

Required switch 

The SIZE switch is required with the ADD VDISK command. 

Switch defaults 

The following defaults are used for the ADD VDISK command when nothing is specified: 

MIRRORCACHE=Mirrored 
WRITECACHE=WriteBack 
OS_UNIT_ID= defaults to zero 
PREFERRED_PATH= defaults to NOPREFERRED_PATH 
REDUNDANCY= defaults to Vraidl 

DISK_GROUP= \Disk Groups\Def ault Disk Group 
READ_CACHE 
NOWRITE_PROTECT 

NOTE: 

t_l If the Default Disk Group has been renamed, not specifying a disk group will result in error. 
Examples 

ADD VDISK "\Virtual DiskXscratch" SIZE=10 REDUNDANCY=VRAID5 
READ_CACHE 

This example creates a 10-GB virtual disk scratch within the default disk group using read cache and 
a VraidS redundancy level. 

ADD VDISK "Wirtual Di sks \engineer ing\gene_research" SIZE=2 

DISK_GROUP="\Disk Groups \ small_di sks " 
This example creates a 2-GB disk at Vraidl redundancy level in the small_disksgroup disk group. 

■mi4> NOTE: 

Remember that this name is the <f amily_name> and that "Wirtual Disks\ <f amily_name> 
\ACTIVE" is the name of the ACTIVE virtual disk. You must use this full path (enclosed in double quotes) 
when referring to it with any other commands, or you can use aliases. 



CAPTURE (CONFIGURATION) 

Syntax 

CAPTURE CONFIGURATION <file name> 
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CAPTURE CONFIGURATION queries the currently selected array and creates from one to five utility 
scripts. Not all arrays require all five scripts. For example, stepl A is always generated and may be 
the only file that is required. You use these scripts to recreate the original configuration, and in some 
cases, to assist in the recovery of a site. 

The scripts output to the console unless you specify a file name. The CAPTURE CONFIGURATION 
command generates five files. Given a file name, stepxx is appended after the file name and 
before the extension. XX is the restore step name, which is lA, IB, IC, 2, or 3. For example, 
specifying CAPTURE CONFIGURATION newyear.txt causes the utility to create the files 

newyear_SteplA.txt, newyear_SteplB.txt, newyear_SteplC.txt, newyear_Step2.txt, 
and newyear_Step3.txt. 

The utility checks to see if any files by the names to be generated exist. If the file names exist, and you 
are entering the command manually, the utility will prompt you to replace existing files with the new files. 
If you are using a script, existing files will be replaced with the new files. 

When creating files that contain the scripts, activity dots display on the console. This command may take 
a long time to complete depending on the size of the configuration. 

NOTE: 

LI Do not reconfigure the selected array while this command is executing. 

Step 1 scripts 

The division of step 1 into three smaller steps facilitates data replication (DR) recovery. 
Step 1 A script 

Creates the array, disk groups, hosts, and virtual disks that are not used for data replication and LUNs for 
the created disks. Stepl A creates a basic system that does not include DR virtual disks or DR Groups. 
CAPTURE CONFIG always creates this step. 

Step 1 B script 

Creates all source virtual disks used in DR Groups on this controller. 
Step 1 C script 

Presents all source virtual disks (creates LUNS) that are used for DR Groups to their hosts. This step exists 
to assist in recovering from a DR failure in which a source site was lost. LUNs can be presented in their 
original configuration by running the correct step IC script. 

Step 2 script 

Recreates all DR-specific configuration information for which this array is the source. This involves the 
configuration's source DR_GROUPs and their members only. Presentations of remote virtual disks are not 
restored by this command (see step 3). 

This step provides flexibility when a site is completely lost. Both source and destination have separate 
CAPTURE CONFIGURATION scripts, so you must run step 1 A, step 1 B, and step 1 C on the source array 
and then run step lA, step 1 B, and step IC on the destination arrays before step 2 can be run. 

rm-i4> NOTE: 

If no destination virtual disk is presented to a host, a blank script will be generated for script 3. 
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Step 3 script 

Presents remote virtual disks (creates LUNS) used for DR Groups to their hosts. 

You must run step 2 on both source and destination arrays before step 3 can be run. 

Restoring configurations 

To restore system configuration from captured scripts, you must run the following scripts in the following 
order on each array that is part of the DR configuration. 

Be aware that a specific captured configuration may not be recreated on some arrays. For example, if 
a captured configuration demands 120 disks and the target array contains only 80, the captured 
configuration will not be successful. 

1 . Select a manager to specify which HP Command View EVA will perform the script commands. 

2. Select the array Uninitialized Storage System (WWN) to specify the uninitialized 
storage system on which you want to recreate the captured configuration. 

3. Run scripts lA, IB, and IC successfully (and separately) on both source and destination arrays 
in the DR configuration. 

4. Run the step 2 script successfully (and separately) on both source and destination arrays in 
the DR configuration. 

5. Run the step 3 script successfully (and separately) on both source and destination arrays in 
the DR configuration. 

Once these scripts have been run against all arrays, the DR configuration is restored to its original state. 

Example 

CAPTURE CONFIGURATION c:\sales.txt 

This example creates the files sales_SteplA.txt, sales_SteplB.txt, sales_SteplC.txt, 
sales_Step2.txt, and sales_Step3.txt. 

riM^ NOTE: 

Refer to the FILE command for further information about restoring configurations. 



CAPTURE (VALIDATE) 

Syntax 



CAPTURE VALIDATE <file name> 



CAPTURE VALIDATE checks the specified script file for modification by calculating its checksum and 
comparing the result against the checksum saved in the file. A script may have been modified (failed 
the CAPTURE VALIDATE command) but may still work. The utility runs a script even if its checksum 
shows file modification. 



CAPTURE VALIDATE example 

This example determines whether the file name was modified. 
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User functionality for CAPTURE commands 



CAPTURE VALIDATE is a switch that determines if a captured script text file has been edited and modified 
after it was captured. This allows the user to determine whether the script is a perfect capture of the 
existing array or if someone has modified it after it was created. 



rm<A> NOTE: 

The specified script is not executed by this command; the script is checked only to see whether it is 
original or not. 



When a script is captured by the CAPTURE commands, a header is written at the front of the text file and 
a checksum is written at the end. If CAPTURE VALIDATE does not see a correct header, it reports that 
the script specified is not a CAPTURE-generoted script. If the checksum does not match, this command 
reports that the file has been modified. 

If and only if a correct header is found and the checksum matches, this command reports that the 
CAPTURE script specified is unmodified. 



DELETE 

Use the DELETE commands to remove arrays, folders, disk groups, DR Groups, virtual disks, hosts, 
systems, and LUNs from the array. You can control the behavior of all DELETE commands with the 
SET OPTIONS command (see "SET OPTIONS" for details on how to use the SAFE_DELETE and 
NOSAFE_DELETE switches). 

DELETE DR_GROUP 

Deletes the DR Group on the source and destination array. The SET OPTION NOSAFE_DELETE does not 
override this requirement. You con delete a DR Group on the source array at any time. 

Syntax 

DELETE DR_GROUP <dr_group_name> 

Example 

DELETE DR_GROUP "\Data Replication\payroll" 
This example deletes the payroll DR Group. 

DELETE DISK_GROUP 

Use the DELETE DISK_GROUP command to delete a disk group from the configuration. The command is 
rejected if any virtual disks are present in the disk group. 

Syntax 

DELETE DISK_GROUP <group_name> 

Example 

DELETE DISK_GROUP "\Disk Groups\human_resources" 
This example deletes a disk group named human_resources. 
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DELETE FOLDER 



Use the DELETE FOLDER command to delete the specified empty folder. The DELETE_FOLDER command 
fails if the specified folder is not empty. To delete multiple layers of folders, you must do so sequentially 
(you cannot delete a root level folder). 

Syntax 

DELETE FOLDER <f older_name> 

Examples 

DELETE FOLDER \Host s \human_resources 

This example deletes a folder named human_resources within the Default Hosts folder. 
DELETE FOLDER \Host s \colorado \colorado_spr ings \engineer ing 

This example deletes the folder named engineering nested in the path \Hosts\colorado\col- 

orado_springs . 

DELETE HOST 

The DELETE HOST command deletes a host from the array. 

Syntax 

DELETE HOST <host_name> 

Example 

DELETE HOST \Host s \development 

This example deletes the host named development. 

DELETE LUN 

Use the DELETE LUN command to remove access to a virtual disk through the LUN from a host. 

Syntax 

DELETE LUN <LUN_name> 

Example 

DELETE LUN " \Host s \account ing department \ 12 " 

This example removes access to LUN 12 from the host accounting_department. 
NOTE: 

t_l Aliases will not work for LUN names. When you specify a LUN, you need to use the full names. 



DELETE SYSTEM 



Use the DELETE SYSTEM command to permanently remove the array. The array will no longer be 
accessible, and all data will be lost. 
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CAUTION: 

The DELETE SYSTEM command removes the entire array configuration. All customer data on the 
entire array is lost when you run this command. In addition, all information about LUNs and hosts on 
this array is lost. 

The DELETE SYSTEM command will be rejected if virtual disks exist. Refer to the SET command for the 
NOSAFE_DELETE behavior. 



Syntax 

DELETE SYSTEM <system_name> 

Example 

DELETE SYSTEM payroll 

This example deletes the array named payroll. 

DELETE VDISK 

Use the DELETE VDISK command to permanently remove the specified virtual disk. The virtual disk is no 
longer accessible, and all data is lost. 



A CAUTION: 

The DELETE VDISK command removes the entire virtual disk from the array. All customer data on the 
specified storage is destroyed when you run this command. In addition, all information about the LUNs 
presented from this virtual disk is lost as well. 

The DELETE VDISK command will be rejected if the virtual disk is presented. See SET OPTIONS — 
NO_SAFE_DELETE for behavior. 



r"-V NOTE: 



When you delete a container, the option V/AIT_FOR_COMPLETION is ignored. After deletion, the 
container may still appear during an LS command. This is because the container is deleted in the 
background and will continue to appear until it is fully deleted (this is an asynchronous only operation). 



Syntax 

DELETE VDISK <storage_name> 



Switches 

The following switches are available with the DELETE VDISK command. 
WAIT_FOR_COMPLETION 

Waits until the command's operation completes before displaying the next utility prompt (and returning 
control) or before running another script line. For large (greater than 1 TB) virtual disks, using this option 
can result in a long period before the prompt displays. 

NOWAIT_FOR_COMPLETION 

Default. Returns control as soon as possible. Some operations are invalid until the initial operation 
completes in the background. 
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Examples 

DELETE VDISK "\Virtual Disks\dl2\ACTIVE" WAIT_FOR_COMPLETION 

This example deletes active and the virtual disk family dl2. WAIT_FOR_COMPLETION prevents the 
utility prompt from displaying until the virtual disk deletion is completed. 

DELETE VDISK "Wirtual Di sks \daily_bi z \wed_nite_biz " 

This example deletes the snapshot wed_nite_biz and does not v/ait for completion. 



■"■V NOTE: 



You cannot delete ACTIVE if a snapshot of the virtual disk exists. You must delete the snapshot and 
then delete ACTIVE. 



EMVERSION 

The EMVERISON command displays the element manager version and build number. 

Syntax 

NoSystemSelected: EMVERSION 
rwijp NOTE: 

t— I You will need to select a manager using the SELECT MANAGER command before using the EMVERSION 
command, but you do not need to select an array. 

Switches 

No additional keyv/ords, parameters, or switches are available with the EMVERSION command. 

Example 

EMVERSION 

Element manager information 
Version : 4.00 
Build: 30 

EXERCISE_DISK 

This command allows users to test hard disks in the array for defects. 

Syntax 

EXERCISE_DISK 

Switches 

The following switches are available with the EXERCISE_DISK command. 
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START 

Begins testing, or exercising, the disks. The options are: 

• All 

Tests all disks in a selected array. 

• List of fully qualified disk names to exercise, comma separated and enclosed in quotes. 
Tests specific disks as specified in the command. 

STOP 

Stops the testing. 
SUMMARY 

Provides a summary report of the testing. This can be used to show status while testing is in progress and 
also when testing is complete. 

The following is a sample output: 

ssl> exer start "\Disk GroupsXUngrouped Disks\Disk 002" 
ssl> exer sum 

DILX Summary Report for Storage Cell ssl 



DILX process status: DILX Testing In Progress 
Number of devices tested: 1 
Disk 002 



Device handle: 
noid: 0x808 
id_type: 0x7 
id_len: 0x10 
id_value[0]: 0x20000004 
id_value[l]: 0xcf792125 
id_value [2] : 0 
id_value [ 3 ] : 0 

Device status: Testing in progress. 

Total blocks transferred: 12098 

Total reads issued: 329 

Total writes issued: 77 

1st bad sense key: 0 

2nd bad sense key: 0 

1st error flag: 0 
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2nd error flag: 
Soft error count 
Hard error count 
1st bad ASC: 0 
2nd bad ASC: 0 
1st bad ASQ: 0 
2nd bad ASQ: 0 
ssl> exer stop 

Examples 

exercise_disk start "\Disk Groups \Default Disk Group\Disk 002, 

\Disk Groups\Def ault Disk Group\Disk 004" 
This example exercises Disk 002 and Disk 004. 
exercise_disk start all 
This example exercises all disks. 

EXIT 

The EXIT command terminates the utility session. 

If the utility is accepting input from the terminal or the command line, EXIT causes the program to terminate. 

If the utility is processing a script from a file while encountering a FILE command, the behavior of the EXIT 
command depends on how the FILE command was issued: 

• If the FILE command was issued from the command line, an EXIT command in the file causes 
the utility to terminate. 

• If the FILE command was issued from the terminal, an EXIT command in the file causes the utility to 
return to accepting input from the terminal. 

• If a file is currently executing as a result of another FILE command, an EXIT command in that file 
returns control to the previous file. The utility does not run any commands in a script beyond the 
EXIT command. EXIT causes an immediate return to the "calling" layer. 

Syntax 

EXIT 

Example 

EXIT 

The utility terminates. 

FILE 

The FILE command causes the current mode of input to be suspended and redirects the scripting utility to 
accept input from the specified file. Either the end of the file or an EXIT command in the specified file 
causes the utility to again accept input from the previous input source. 



0 

0 
0 
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FILE commands can be nested. Nesting FILE commands means that a file being executed through a FILE 
command can have FILE commands within its command set. The only limitation on how deep FILE 
commands may be nested is based on the host array's resources. 



Syntax 

FILE <filename> 

An extension is not required by the utility, although you can choose one appropriate to your environment. 

Examples 

FILE snapdl.txt 

This example executes the file snapdl .txt from the current directory. 

FILE d: \ s cr ipt s\ snapshot s\d2 7 .txt 

This example executes a file d2 7 .txt located in the specified directory. 

HELP 

The HELP command displays information about using the utility help. 

To get HELP on specific command syntax, enter a space and a question mark (?) wherever you would 
normally include a parameter, at any level of a command line. The help system will then list the options 
available for that parameter. 

Syntax 

HELP 

Examples 

HELP 

Command syntax help is available at any point within a command by typing a '?' 

This example accesses HELP and requests the display of the different valid values for the switch 
REDUNDANCY. 

Add VDISK my_Vdisk REDUNDANCY= ? 
The system displays: 

The options are: 

VRAIDO 
VRAIDl 
VRAID5 
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LS 



rm\4> NOTE: 

With this version of the utility, the LS commands have replaced the SHOW commands. The SHOW 
commands are still available; hov/ever, they are deprecated. 



The LS commands display information about various devices in the currently selected array. If you specify 
the name of an object, the LS command will display detailed information on the object. 

The following object types are available for all of the LS commands (except where indicated): 
CONTAINER, CONTROLLER, DISK, DISK_GROUP, DISKSHELF, DR_GROUP, FOLDER, HOST, LUN, 
SYSTEM, VDISK, MANAGER, OPTIONS, SNAPSHOT, TIME, AND WORLD_WIDE_NAME.. 

The following list shows how you can use the LS command: 

• LS <object type> FULL 

Lists all the information available for all the objects of that type. 

• LS <object type> FULL XML 

Lists all the information available for all the objects of that type in XML format. 

• LS <object type> NOFULL (This is the default and is a no-operation switch.) 

• LS <object type> <object name>XML — displays the output in extensible markup language (XML). 

Examples 

Example 1 

LS VDISK FULL 

This example provides all information about all virtual disks. 
Example 2 

LS VDISK <name> 

This example displays all the properties of a particular disk. 



LS CONTAINER 



Use the LS CONTAINER command to display information for the containers available on the currently 
selected array. 



Syntax 

LS CONTAINER <container name> 



LS CONTROLLER 

Use the LS CONTROLLER command to display disk configuration information for the controllers connected 
to the currently selected array. 

Syntax 

LS CONTROLLER <controller name> 
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LS DISK 



Use the LS DISK command fo display disk configuration information for physical disks connected to 
the currently selected array. 

Syntax 

LS DISK <disk_name> 

LS DISK_GROUP 

The LS DISK_GROUP command displays the disk groups currently configured by this array. If 
<disk_group_name> is specified, detailed information about the specified disk group is displayed. 

Syntax 

LS DISK_GROUP <disk_group_name> 

LS DR_GROUP 

Use the LS DR_GROUP command to display a list of data replication groups for the currently selected 
array. If you specify the name of the DR Group, the command displays detailed information about 
the specified DR Group. 

Syntax 

LS DR_GROUP <dr group name> 

LS DISKSHELF 

Use the LS DISKSHELF command to display information for the disk enclosures connected to the currently 
selected array. 

Syntax 

LS DISKSHELF <diskshelf name> 

LS FOLDER 

The LS FOLDER command displays a list of folders for the currently selected array. 

Syntax 

LS FOLDER <folder name> 

This example lists the folders available on the array. 

LS HOST 

The LS HOST command displays the hosts currently configured on this array. 

Syntax 

LS HOST <host_name> 
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LS LUN 

The LS LUN command displays the LUNs currently configured on this array. 



rmi^ NOTE: 

Aliases cannot be used for LUNs. 



Syntax 

LS LUN <LUN name> 

LS MANAGER 

The LS MANAGER command displays information about the currently selected manager. 
1-3^ NOTE: 

This command does not have an XML output option. 

Syntax 

LS MANAGER 



Switch 



The switches FULL and NOFULL can be specified but are ignored. Specifying a manager name is also 
ignored. The LS MANAGER command always displays the information for the currently selected manager. 



LS OPTIONS 

The LS OPTIONS command displays the current utility options. 



rmi^ NOTE: 

This command does not have an XML output option. 



Syntax 

LS OPTIONS 

LS SNAPSHOT 

Use the LS SNAPSHOT command to display the snapshots. 

Syntax 

LS SNAPSHOT <snap name> 

LS SYSTEM 

Use the LS SYSTEM command to display the arrays currently managed by HP Command View EVA. 
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Syntax 

LS SYSTEM <system_name> 

LS TIME 

Use the LS TIME command to display the current time for the selected array. 



■^14> NOTE: 

This command does not have an XML output option. 



Syntax 

LS TIME 

LS VDISK 

The LS VDISK command displays the storage currently configured on this array. 

Syntax 

LS VDISK <vdisk name> 

LS WORLD_WIDE_NAME 

The LS WORLD_WIDE_NAME command displays the host World Wide Names (WWNs) that are visible 
to this array and not already assigned to a host. 

NOTE: 

t— I This command does not have an XML output option. 
Syntax 

LS WORLD WIDE NAME 



REDISCOVER 

This command tells HP Command Viev/ EVA to conduct rediscovery to find new arrays or update 
the status of existing arrays. For example, when communication has been lost and then restored, 
REDISCOVER could be used. 

Syntax 

REDISCOVER 

RESTART 

Use the RESTART command to restart a controller shown by the LS CONTROLLER command. 
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Syntax 



RESTART <controller_name> 

Switches 

The following switches are available for the RESTART command: 
ALLPEERS 

Restarts all peer controllers (both controllers) on this array. 

NOALLPEERS 

Default. Restarts only the specified controller. 

Examples 

RESTART "\Hardware\Rack l\Enclosure 7\Controller B" ALL_PEERS 
This example restarts Controller B, and its peer controller. 

RESTART "\Hardware\Rack l\Enclosure 7\Controller A" NOALL_PEERS 
This example restarts Controller A but not its peer controller. 

SELECT 

Use the SELECT commands to select a manager or an array. After you select an array, the prompt 
changes to reflect the selected array. 

SELECT MANAGER 

Use the SELECT MANAGER command to direct the command prompt to a selected HP Command View 
EVA or EVA server. All configuration commands run on the selected HP Command View EVA or EVA 
Command View instance and affect its array's configuration. The <manager_name> can be a server, 
management server name, or an IP address. Unless the SAN administrator has changed the password, 
the default password is "administrator" and the default user is "administrator." The user name and 
password for the manager are validated in the background on every command. 

Syntax 

SELECT MANAGER <manager_name> USERNAME=<username> 
PASSWORD=<password> 

Switches 

The following switches are available for the SELECT MANAGER: 
PASSWORD= 

Password associated with the user name that you use to access the HP Command View EVA. 
USERNAME= 

User name that you use to access the HP Command View EVA. 
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Required switches 

The following switches ore required with the SELECT MANAGER command: 

• PASSWORD= 

• USERNAME= 

Example 

SELECT MANAGER north_campus USERNAME=XXX PASSWORD=XXXX 
This example selects the manager north_campus. 

SELECT SYSTEM 

Use the SELECT SYSTEM command to direct the command prompt to the selected array or manager. 
All configuration commands then affect the selected array. If the system name has spaces in it, the 
name must be enclosed in double quotes (""). 

Syntax 

SELECT SYSTEM <system_name> 

Examples 

SELECT SYSTEM employees 

In this example, the employees array is selected. 

SELECT SYSTEM "payroll storage" 

In this example, the array payroll storage is selected. 

SET 

Use the SET commands to change the properties of a: disk, disk group, DR group, folder, host, controller, 
options, system, disk shelf or virtual disk. 

r^f NOTE: 

t— I You can perform only one property change per SET command. 

SET DR_GROUP 

Use SET DR_GROUP to set the mode of operation of an existing DR Group. 

Syntax 

SET DR_GROUP <dr_group_name> 

Switches 

The switches available with the SET DR_GROUP command are described in the following paragraphs. 
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NOTE: 

Note that from the destination side, a user can set only the COMMENT and NAME switches. 



ACCESSMODE= 

The access rights for a connected host. Possible values are READONLY, PRESENTONLY and DISABLE. 
ADD_VDISK= 

Name of a source array virtual disk to be added to the DR Group. A destination virtual disk is 
automatically created on the destination array. 



NOTE: 

If a name is already in use, the name will be rejected and you will be asked to enter a new name. 



When adding a virtual disk to the DR Group, the following two optional switches can be specified: 

• DESTINATION_DISK_GROUP= The disk group name on the destination array on which the virtual 
disk is created. This switch can be specified only after the ADD_VDISK switch. 

• DESTINATION_VDISK_NAME= The name of the virtual disk that is created on the destination 
array. The default name is the same as that of the source. This optional switch can be specified 
only after the ADD_VDISK switch. 

• TARGETREDUNDANCY= The redundancy level of the virtual disk that is created on the destination 
array. 

COMMENT= 

An optional field for attaching comments to the DR Group being created. This string must be enclosed in 
quotes. The maximum number of characters for this switch is 64. 

DELETE_VDISK= 

Name of a source array virtual disk to be removed from the DR Group. The corresponding destination 
virtual disk on the destination array is removed from the DR Group and deleted from the array. 

DETACH_VDISK= 

Name of a source array virtual disk to be removed from the DR Group. The corresponding destination 
virtual disk on the destination array is removed from the DR Group but not deleted. The detached 
destination virtual disk continues to exist as an independent virtual disk. 

FAILOVER_SUSPEND 

The FAILOVER_SUSPEND command instructs the controller to perform the failover and after the failover is 
done, suspend the connection between the DR groups. 

FAILOVER RESUME 

The FAILOVER RESUME command instructs the controller to perform the failover and after the failover is 
done, resume the connection between the DR groups. 
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FAILSAFE 



When you use the FAILSAFE switch and the connection between the source and the destination array 
fails, all writes are immediately halted and no write is reported as complete until either the connection is 
restored or the NOFAILSAFE switch is set. 

FORCEFULLCOPY 

The FORCEFULLCOPY forces the DR Groups member to fully copy the source members to the destination 
members and ignore the DR log. 

LINK_DOWN_AUTOSUSPEND= 

When this switch is enabled, the DR replication is automatically suspended if the link between the arrays 
goes down. It will stay suspended even if the link returns. The possible values are: ENABLED or DISABLED. 

MAX_LOG_SIZE= 

This is the maximum size for the DR log disk. The value is the number of blocks in 51 2 bytes. If left 
blank or set to "0", the controller firmware will calculate the best log size for the space available. 
Otherwise, you can specify a size, which must be between 1 36MB and 2TB entered in blocks: 278528 
through 4294967296. 



NOTE: 

If you specify a size that is larger the available disk space, the command will complete successfully, and 
the DR Group will be created (even though the space is not available). If additional disks are added to 
the configuration, the controller will allocate more data for the DR log. 



NOFAILSAFE 

This is the default when you first create the DR Group. When the connection between the source and 
the destination array fails, writes are directed to the log until the connection is restored. When the 
connection is restored, the pending destination writes are pushed across to the destination array. If the 
log becomes full, the array makes a full copy of the source virtual disk to the destination virtual disk when 
the connection is restored. Otherwise, the log resynchs the source and destination virtual disks. 

NAME= 

This is the new name for the specified DR Group. 
SUSPEND 

This option stops replication of data from the source to the destination. This causes the same behavior as 
if the connection failed. 

NOSUSPEND 

This option allows replication of data from the source to the destination to resume. This causes the 
same behavior as if the connection was restored. 

WRITEMODE= 

This option defines the I/O interaction between the destination and source side. Possible values are 
synchronous and asynchronous. 
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Example 

SET DR_GROUP "\Data Replication\Transactions" SUSPEND 
This example suspends replication for the DR Group Transactions. 

SET DISK 

The SET DISK command changes the properties of a disk. 

Syntax 

SET DISK <name> 

Switches 

The switches available for the SET DISK command are described in the following paragraphs. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new array. A maximum of 1 28 
characters is allowed and the string must be enclosed in double quotes. 

NAME= 

This is the new name to give to the specified disk. 
Example 

SET DISK "\Disk Groups \Ungrouped Disks\Disk 005" NAME=5Disk 
This example renames the disk Disk 005 to 5Disk. 

SET DISK_GROUP 

The SET DISK_GROUP command changes the specified disk group properties. 

Syntax 

SET DISK_GROUP <name> 

Switches 

The switches available with the SET DISK_GROUP command are described in the following paragraphs. 
ADD= 

This is the number of disk drives to add to the specified disk group. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the disk group. A maximum of 1 28 
characters are allowed and the string must be enclosed in double quotes. 

DELETE= 

The name of the disk drive to be removed from the disk group. 
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NAME= 

This is the new name to give to the specified disk group. 
OCCUPANCY_ALARM= 

This is the point when a defined percentage of space is used. When this point is reached, an event is 
generated and sent to the host informing the administrator that the group is becoming full. Do not use the 
percentage sign (%) after the number. 

SPARE_POLICY= 

This parameter determines the amount, if any, of storage space set aside for use in the event that disks 
fail. The default is single. 

• NONE— reserves no space within a disk group to allow for data reconstruction for failure of 
disk drives 

• SINGLE— reserves space within a disk group to allow for data reconstruction for failure of a 
single disk drive 

• DOUBLE— reserves space within a disk group to allow for data reconstruction for failure of 
two disk drives 



The space set aside is not in numbers of physical disks. It is the equivalent amount of storage space 
spread across all disks. 

Example 

SET DISK_GROUP "\Disk GroupsXpool" NAME="nuclear secrets" 
This example renames the disk group pool with the new name nuclear secrets. 



Syntax 

SET FOLDER <name> 

Switches 

The switches available for the SET FOLDER command are described in the following paragraphs. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new system. A maximum of 
1 28 characters is allowed, and the string must be enclosed in double quotes. 




SET FOLDER 



The SET FOLDER command changes the specified folder properties. 
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NAME= 

New name to give to the specified folder. 

Example 

SET FOLDER "Wirtual Disks \top_secret " NAME=everyone_knows 
This example renames the folder named top_secret to everyone_knows. 

SET HOST 

The SET HOST command changes the host parameter values. 



rwjo NOTE: 

Use the SET HOST command to add additional FCAs to hosts added to the array with the ADD HOST 
command. 



Syntax 

The following switches are available with the SET HOST command. 
ADD_WORLD_WIDE_NAME= 

This adds the World Wide Name of the host port list. 
DELETE_WORLD_WIDE_NAME= 

This option deletes the World Wide Nome of the host port list. 
COMMENT= 

This is on optional switch that associates a user-defined comment with the new array. A maximum of 1 28 
characters is allowed, and the string must be enclosed in double quotes. 

IP= 

This option is the network IP address. 
NAME= 

This is the new name given to the specified host. 
OPERATING_SYSTEM= 

This is the type of operating system for the specified host. Choose one of the following operating systems, 
which are spelled here as the utility expects: 
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• HPUX 

• IBMAIX 

• LINUX 

• OPEN_VMS 

• SOLARIS 

• TRU64 

• UNKNOWN 

• WINDOWS 

• CUSTOM = (You must include the equal sign after CUSTOM, and the value must be 16-digit 
hexadecimal characters.) 

Examples 

SET HOST \Hosts\install OPERATING_SYSTEM=OPEN_VMS 

This example assigns OpenVMS as the operating system type for the host install. 

SET HOST \Hosts\install ADD_W0RLD_WIDE_NAME=1 0 0 0-0 0 0 0-C 92 2-3 6CA 
This example adds a WWN to the host install. 

SET CONTROLLER 

The SET CONTROLLER command changes the specified controller properties. 

Syntax 

SET CONTROLLER <name> 

Switches 

The following switches are available with the SET CONTROLLER command: 
COMMENT= 

This is an optional switch that associates a user-defined comment with the controller. A maximum of 1 28 
characters (including spaces) is allowed, and the string must be enclosed in double quotes. 

NAME= 

New name to give to the specified controller. 

SET DISKSHELF 

The SET DISKSHELF command changes the specified disk enclosure properties. 

Syntax 

SET DISKSHELF <diskshelf name> 

Switches 

The only switch available for the SET DISKSHELF command is COMMENT. 
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COMMENT= 



This is an optional switch that associates a user-defined comment with the disk enclosure. A maximum of 
128 characters (including spaces) is allowed, and the string must be enclosed in double quotes. 

SET OPTIONS 

The SET OPTIONS command changes the utility characteristics. 
NOTE: 

The options you set with the SET OPTIONS command are in effect for the current session only. Each time 
you start the utility, the default options are reinstated. 

Syntax 

SET OPTIONS 

Switches 

The following switches are available with the SET OPTIONS command. 
COMMAND_DELAY= 

The number of seconds (0-300 seconds) to wait between issuing commands when running a script using 
the FILE command. The default is 10 seconds. This switch has no effect when you are typing commands 
at the command line. 

NOCOMMAND_DELAY 

Specifies that no wait time occurs between commands issued from within a FILE command. 
DISPLAY_WIDTH= 

Sets the amount of characters displayed on a line for LS commands. The default is 80. If the utility output 
is to be parsed, it is useful to set a high line width. A long line keeps the lines from wrapping, making the 
output easier to cut, paste, and parse. Line widths from 70 to 500 may be specified. 

ON_ERROR= 

• CONTINUE — In this mode, only the EXIT command causes the scripting utility to halt. This is the 
default and is recommended when you are manually typing commands. 

• EXIT_ON_ERROR— Any error causes the scripting utility to exit with an error code. This mode 
is useful when requesting the entire script to halt immediately if errors occur while executing a 
script. This causes the scripting utility to exit on any kind of error: failed command, syntax error, 
or ambiguous command. 

• HALT_ON_ERROR— This is similar to EXIT_ON_ERROR. Any error causes the scripting utility to 
halt but not exit until any key is pressed. Then the scripting utility exits with an error code. This 
allows you to see the error before the window closes on exit. 

■wj^ NOTE: 

When you are entering commands manually, HP does not recommend using the EXIT ON ERROR or 
HALT ON ERROR modes. You should avoid these modes because the utility exits on any kind of error, 
including a typographical one. 



HP StorageWorks Storage System Scripting Utility reference 



61 



RETRIES= 

The number of minutes to attempt long period retries, such as when the command view EVA service is 
busy or restarting. Specify between 1-1 20 minutes (inclusive). The default is four minutes. 

NORETRIES 

Specifies that you do not want the scripting utility to retry commands. 
SAFE_DELETE 

Specifies if you want to delete all dependent or related objects before the specified object can be deleted. 
For example, if you specified a deletion of the virtual disk that had LUNs presented, the DELETE VDISK 
command would be rejected with a message telling you that all the LUNs presented from this storage 
must be deleted before the storage can be deleted. 

This is the default. You must always delete related objects if SAFE_DELETE is specified. 
NOSAFE_DELETE 

Allows the deletion of an object even if related objects are present. The behavior of the NOSAFE_DELETE 
command depends on the mode of operation (entering commands manually or running commands 
through a script) in which the utility is running. 

If you are entering commands at a terminal, the Are you sure? prompt displays and you must type Yes 
for the deletion to proceed. 



NOTE: 

E— I If you try to delete a virtual disk that is presented, the NOSAFE_DELETE switch will not allow the 
deletion. The NOSAFE DELETE switch will allow you to delete an entire array (which may contain 
presented virtual disks). 

You must type Yes to proceed. 

If you are in a FILE command in a script and you have set NOSAFE DELETE, it will delete the virtual 
disk without a prompt. 



A CAUTION: 

Using the NOSAFE_DELETE switch can cause accidental deletion of virtual disks or presentations. 

Example 

SET OPTIONS ON_ERROR= HALT_ON_ERROR NORETRIES 

This example sets the options for the utility to stop upon encountering an error and not to retry the 
commands. 

SET SYSTEM 

Use the SET SYSTEM command to modify array properties. 
m!4> NOTE: 

The SET SYSTEM CONSOLE_LUN_ID value is used for IBM AIX (set to zero), OpenVMS (required), and 
Tru64 UNIX (recommended). Other host operating systems ignore the value. Refer to the host operating 
system installation guides that came with your host system for more information. 
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Syntax 

SET SYSTEM <name> 

Switches 

The following switches are available for the SET SYSTEM command. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new array. A maximum of 1 28 
characters is allowed, and the string must be enclosed in double quotes. 

CONSOLE_LUN_ID= 

This is the LUN used for console communication. If set to zero, a console LUN is not presented to the host. 
NAME= 

This is the new name to give to the specified array. 
MANAGE 

This specifies the array to be managed by the selected manager. 
NOTE: 

This option allows switching between multiple instances of HP Command View EVA. 
Example 

SET SYSTEM engineering NAME=accounting 

This example renames the array engineering to accounting. 

SET VDISK 

Sets the parameters of the virtual disk. 

Syntax 

SET VDISK <vdisk name> 

Switches 

The following switches are available for the SET VDISK command. 
COMMENT= 

This is an optional switch that associates a user-defined comment with the new array. A maximum of 1 28 
characters is allowed and the string must be enclosed in double quotes. 

CHANGE_INTO_CONTAINER 

This is an optional switch that changes a vdisk back into an empty container. 
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NOTE: 



Note that the CHANGE_INTO_CONTAINER option (SET VDISK command) will create an empty 
container and erase any data in the virtual disk. 



MIRRORCACHE= 

This sets the controller's mirror cache. The values are MIRRORED (cache is mirrored betv/een both 
controllers) and NOTMIRRORED (cache is not mirrored). 



NOTE: 

For active-active controllers, the only option is MIRRORED. If you try to set to NOTMIRRORED, you 
will get an error. 



NAME= 

This is the new name to give to the specified virtual disk. 
OS_UNITJD= 

This is the ID that is presented to the host operating system. If set to zero, an ID is not presented to the host. 
PREFERRED_PATH= 

This is the preferred controller path that is specified to handle all I/O for the virtual disks. If a controller 
fails, the path always reverts to the working controller. 

• PATH_A_BOTH— Controller path A fails over to controller B. When controller A restarts, the virtual 
disks fail back to controller A. This is failover/failback mode. 

• PATH_A_FAILOVER— Controller path A fails over to controller B. When controller A restarts, the 
virtual disks do not fail back over to controller A. This is failover-only mode. 

• PATH_B_BOTH— Controller path B fails over to controller A. When controller B restarts, the virtual 
disks fail back to controller B. This is failover/failback mode. 

• PATH_B_FAILOVER— Controller path B fails over to controller A. When controller B restarts, the 
virtual disks do not fail back over to controller B. This is failover-only mode. 

NOPREFERRED_PATH 

This allows the I/O to be handled by any controller. 
READ_CACHE 

This specifies the reads are satisfied from the controller's cache. 
NOREAD_CACHE 

This specifies the reads are always satisfied from media, not the controller's cache. 
SIZE= 

This indicates the new larger size (you cannot change to a size smaller than the original) of the storage in 
gigabytes. You can specify size in whole gigabytes only. Fractions are not allowed. The value of SIZE 
can be 2 GB through 2000 GB depending on the disk group's available space. 
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WORLD_WIDE_LUN_NAME= 

This sets the World Wide LUN Name on unpresented storage (either ACTIVE or snapshot). This switch is 
rejected when issued against storage that is presented to a host. 

r2«jjp NOTE: 

This switch is commonly used to allow a host to point to a new version of a snapshot by giving the new 
snapshot the same WWN as the old snapshot. 

WRITE_PROTECT 

This does not allow writing to the virtual disk for all presented LUNs. 
WRITE_CACHE= 

This is the cache parameter for the write operation. There are two values: WRITETHROUGH and 
WRITEBACK. With WRITETHROUGH the operation completes when the write to disk completes. With 
WRITEBACK, the operation completes when the data is written to cache. 

NOWRITE_PROTECT 

This allows writing to the virtual disk for all presented LUNs. 

Example 

SET VDISK "Wirtual Di sks \archive \ACTIVE" 

WORLD_WIDE_LUN_NAME=6000-lfel-ff 00-0000 
This example assigns the World Wide LUN Nome to the ACTIVE virtual disk of the archive family. 

SHUTDOWN 

Use the SHUTDOWN command to shut down any controller displayed by the LS CONTROLLER command. 

Syntax 

SHUTDOWN <controller_name> 

Sv/itches 

The following switches ore available with the SHUTDOWN command. 

• ALL_PEERS 

Shuts down all peer controllers (both controllers) on this array. This will also power off all disk 
enclosures. 

• NOALL_PEERS 

Default. Shuts down only the specified controller. 

Examples 

SHUTDOWN "\Hardware\Rack l\Enclosure 7\Controller A" 
This example shuts down only Controller A. 

NOALL_PEERS 
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SHUTDOWN "\Hardware\Rack l\Enclosure 7\Controller B" ALL_PEERS 
This example shuts down Controller B and the peer. 
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3 Configuration examples 



This chapter provides an example that describe how to use commands to create a simple configuration 
and to view specific array information. 

Select a management server cvevaserver to manage using the user default username and password 
(administrator/administrator): 

NoSystemSelected : select manager cvevaserver username=administrator 
password=aclministrator 

List the Systems (use the LS SYSTEM command to list arrays): 

NoSystemSelected: Is system Systems available on this Manager: 
Uninitialized Storage System [ 50 00-lFEl-OO 15-1F50 ] 

Select an array using the SELECT SYSTEM command (if an array is uninitialized, it will be shown 
"Uninitialized Storage System" with the world wide name xxxx-xxxx-xxxx-xxxx) : 

NoSystemSelected: select system "Uninitialized Storage System [ 500 0-lFEl-O 015-1F50 ] " 

Add an array "Archive" (use the help system (?) to show available switches): 

Uninitialized Storage System [ 50 00-lFEl-OO 1 5-1F50 ] : add system Archive ? 
The options are: 
COMMENT 

CONSOLE_LUN_ID 
DEVICE_COUNT 
DISKGROUP_DISKTYPE 
SPARE_POLICY 

Add 8 disks to the Archive array: 

Uninitialized Storage System [ 50 OO-lFEl-OO 15-1F50 ] : add system Archive device_count = 8 

Use the LS SYSTEM command to show arrays: 

NoSystemSelected: Is system 
Systems available on this Manager: 

Archive 
Select the array Archive: 

NoSystemSelected: select system Archive 

Add a 10GB virtual disk called History to Archive: 

Archive: add vdisk History size=10 

Add a new host called MainServer (use the help system (?) to list switches for ADD command): 

Archive: add host MainServer ? 
The options are: 
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COMMENT 
IP 

OPERATING_SYSTEM 
WORLD_WIDE_NAME 

Add MainServer to the array using WWN and specifying the operating system (hpux): 

Archive: add host MainServer world_wide_name=1234-4321-1234-4231 operating_system=hpux 

Present virtual disk History as LUN3 to MainServer: 

Archive: add lun 3 vdisk=History host=MainServer 

Use the LS command to list virtual disks available on MainServer: 

Archive: Is vdisk 
Vdisks available on this Cell: 
Wirtual Disks\History\ACTIVE 

Use the LS command to view the virtual disk History: 

Archive: Is vdisk History 

\Virtual Disks\History\ACTIVE information: 
object 

objectid : 00200710b4080560ae420100005002000000c700 

objectname : \Virtual Disks\History\ACTIVE 

objecttype : virtualdisk 

objecthexuid : 6005-08b4-0001-42ae-0002-5000-00c7-0000 

partitionname : ACTIVE 

uid : 8192.7.16.1610942644.82606.151552.13041664 

objectparentuid : 0.7.16.1610942644.82606.151552.12976128 

objectparenthexuid : 6005-08b4-0001-42ae-0002-5000-00c6-0000 

objectparentid : 00000710b4080560ae420100005002000000c600 

creationdatetime : Ol-Feb-2005 17:43:30 

timestampmodify : 687417000 

f amilyname : History 

wwlunid : 6005-08b4-0001-42ae-0002-5000-00c7-0000 

operationalstate : good 

operationalstatedetail : operating_normally 

allocatedcapacity : 10 

virtualdisktype : original 

requestedcapacity : 10 

sharingrelationship : none 

sharingin format ion 

parentvdiskhexuid : n/a 

parentvdiskid : n/a 
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parentvdiskname : n/a 

childvdiskhexuid : n/a 

childvdiskid : n/a 

childvdiskname : n/a 

redundancy : vraidl 

writecache : writeback 

vdisksecondarystate : none 

mirrorcache : mirrored 

readcache : enable 

virtualdiskpresented : yes 

presentations 

presentation 

hostid : 00800710b4080560ae420100005002000000cb00 

lunnumber : 3 

hostname : \Hosts\MainServer 

writeprotect : disable 

osunitid : 0 

diskgroupname : \Disk Groups\Def ault Disk Group 

diskgroupid : 00010710b4080560ae420100005002000000b400 

pref erredpath : no_pref erence 

Use the LS command to list the available hosts on MainServer: 

Archive: Is host MainServer 
Hosts available on this Cell: 
\Hosts\MainServer information: 
object 

objectid : 00800710b4080560ae420100005002000000cb00 

objectname : \Hosts\MainServer 

objecttype : host 

objecthexuid : 6005-08b4-0001-42ae-0002-5000-00cb-0000 

hostname : MainServer 

uid : 32768.7.16.1610942644.82606.151552.13303808 

objectparentuid : 1028.4.4.67372036.67372036. 67372036.67372036 

ob jectparenthexuid : 0404-0404-0404-0404-0404-0404-0404-0404 

ipaddress : dynamic_ip_assignment 

presentations 
presentation 

lunnumber : 3 

virtualdiskid : 00200710b4080560ae420100005002000000c700 

virtualdiskname : \Virtual Disks\History\ACTIVE 
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ope rational St ate 



good 



operationalstatedetail 



initialized_ok 



f cadapterports 



port 



portwwn 



1234-4321-1234-4231 



direct eventing 



enable 



osmode 



hpux 



osmodebitmask 



n/ a 



Use the LS command to list the available LUNs on MainServer storage cell 3: 

Archive: Is lun \Hosts\MainServer\3 
LUNs available on this Cell: 
\Hosts\MainServer\3 information: 

object 

objectid : 0 08 80 7 1 0b4 0 8 0 5 60ae42 0 10 00 05 002 0 00 00 OccO 0 

objectname : \Hosts\MainServer\3 

objecttype : presentedunit 

objecthexuid : 6005-08b4-0001-42ae-0002-5000-00cc-0000 

virtualdiskname : \Virtual Disks \History\ACTIVE 

virtualdiskid : 00200710b4080560ae420100005002000000c700 

hostname : \Hosts \MainServer 

hostid : 00800710b4080560ae420100005002000000cb00 

lunnumber : 3 

Use the LS command to view the LUNs on \Hosts\MainServer\3 v/ith XML option to format output in 



Archive: Is lun \Hosts\MainServer\3 xml 
\Hosts\MainServer\3 information: 

<ob ject> 

<ob jectid>0 08 80 71 0b4 0 80 5 60ae42 010 00 05002 0 00 00 OccO 0</objectid> 
<ob jectname>\Hosts\MainServer\3</ ob jectname> 
<ob jecttYpe>presentedunit</ objecttype> 

<objecthexuid>600 5-08b4-0 00 l-42ae-0 002-50 00-0 Occ-00 00</objecthexuid> 
<objectdiskname>\ Virtual Disks \History\ACTIVE</ ob jectdiskname> 
<ob jectdiskid>0 02 00 71 0b4 0 80 5 60ae42 010 00 050020 00 00 0c70 0</objectdiskid> 
<hostname>\Host s \MainServer</hostname> 

<hostid>0 08 00 710b4 0 80 5 60ae42010 00 050020 0000 0cb0 0</hostid> 
<lunnumber>3</ lunnumber > 
</ ob ject> 

70 Configuration examples 



XML: 



